• feat: add Stainless SDK config and misc cleanups #132 👈 (View in Graphite)
• feat: rename Error to GridError and add additionalProperties to error schemas #131
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

Greptile Overview

Greptile Summary

This PR adds Stainless SDK configuration for generating TypeScript and Kotlin SDKs from the Grid API OpenAPI specification. The changes include SDK generation configuration, error handling improvements, and several bug fixes.

Major changes:

• Added .stainless/stainless.yml with comprehensive SDK configuration including resource mappings, authentication settings, pagination, and error handling
• Added .stainless/workspace.json pointing to mintlify/openapi.yaml as the source spec
• Introduced AllErrors union schema to enable proper typed error handling in generated SDKs via discriminated unions
• Renamed Error schema references to GridError for consistency
• Fixed phoneNumber example in UltimateBeneficialOwner to include '+' prefix matching E.164 format pattern
• Corrected InternalAccount schema reference path from users/ to customers/ directory
• Added lint exceptions for the new AllErrors schema and Quote-related properties

All changes are clean, well-structured, and properly integrated with the existing OpenAPI schema architecture.

Confidence Score: 5/5

• This PR is safe to merge with no concerns
• All changes are configuration and documentation related with no runtime code. The SDK configuration is comprehensive and follows Stainless best practices. Schema fixes are correct (verified InternalAccount exists in customers/ directory, phone format fix matches validation pattern). The bundled openapi.yaml files are auto-generated and consistent with source changes.
• No files require special attention

sequenceDiagram
    participant Dev as Developer
    participant Stainless as Stainless SDK Generator
    participant OpenAPI as OpenAPI Spec
    participant SDK as Generated SDK
    participant API as Grid API

    Note over Dev,Stainless: SDK Configuration Phase
    Dev->>Stainless: Configure stainless.yml<br/>(resources, auth, pagination)
    Dev->>Stainless: Configure workspace.json<br/>(points to mintlify/openapi.yaml)
    
    Note over Stainless,OpenAPI: Schema Processing Phase
    Stainless->>OpenAPI: Read mintlify/openapi.yaml
    OpenAPI-->>Stainless: AllErrors union schema<br/>(Error400-501)
    OpenAPI-->>Stainless: GridError base schema
    Stainless->>Stainless: Transform AllErrors via<br/>splitSchemasByEnumProperty
    
    Note over Stainless,SDK: SDK Generation Phase
    Stainless->>SDK: Generate TypeScript SDK<br/>(grid package)
    Stainless->>SDK: Generate Kotlin SDK<br/>(com.grid.api)
    
    Note over SDK,API: Runtime Usage
    Dev->>SDK: Use generated client<br/>(BasicAuth credentials)
    SDK->>API: Make API request
    API-->>SDK: Error response (400-500)
    SDK->>SDK: Map to typed error<br/>(using discriminator: code)
    SDK-->>Dev: Typed GridError subclass